home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 3.iso / dist / fw_plotutils.idb / usr / freeware / catman / u_man / cat1 / tek2plot.Z / tek2plot
Encoding:
Text File  |  2002-01-08  |  24.5 KB  |  529 lines
  1.  
  2.  
  3.  
  4. TEK2PLOT(1)          GNU Plotting Utilities          TEK2PLOT(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        tek2plot     -  translate  Tektronix  files    to other graphics
  9.        formats
  10.  
  11. SSYYNNOOPPSSIISS
  12.        tteekk22pplloott    [ _o_p_t_i_o_n_s ] [ _f_i_l_e_s ]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        tteekk22pplloott    translates Tektronix graphics files to other for
  16.        mats, or    displays them on an X Window System display.  The
  17.        output format or    display    type is     specified  with  the  --TT
  18.        option.    The possible output formats and    display    types are
  19.        the  same  as  those  supported    by   ggrraapphh(1),     pplloott(1),
  20.        ppiicc22pplloott(1),  and  pplloottffoonntt(1).    If an output file is pro
  21.        duced, it is written to standard    output.
  22.  
  23.        Options and file    names may be interspersed on the  command
  24.        line,  but the options are processed before the file names
  25.        are read.  If ----    is seen, it is interpreted as the end  of
  26.        the  options.  If no file names are specified, or the file
  27.        name -- is encountered, the standard input is read.
  28.  
  29. OOPPTTIIOONNSS
  30.    GGeenneerraall OOppttiioonnss
  31.        --TT _t_y_p_e
  32.        ----ddiissppllaayy--ttyyppee _t_y_p_e
  33.           Select _t_y_p_e as the output    format or  display  type.
  34.           It  may  be  "X",    "png", "pnm", "gif", "svg", "ai",
  35.           "ps", "cgm", "fig", "pcl", "hpgl", "regis",  "tek",
  36.           or  "meta" (the default).     These refer respectively
  37.           to the  X     Window     System,  PNG  (Portable  Network
  38.           Graphics)       format,    portable      anymap   format
  39.           (PBM/PGM/PPM), a pseudo-GIF format  that    does  not
  40.           use LZW encoding,    the new    XML-based Scalable Vector
  41.           Graphics format, the format used by Adobe    Illustra
  42.           tor,  Postscript    or  Encapsulated Postscript (EPS)
  43.           that can be edited with iiddrraaww(1),     CGM  format  (by
  44.           default,    confirming  to    the  WebCGM profile), the
  45.           format used by  the  xxffiigg(1)  drawing  editor,  the
  46.           Hewlett-Packard    PCL   5      printer  language,  the
  47.           Hewlett-Packard Graphics Language,  ReGIS     graphics
  48.           format  (which  can  be  displayed by the    ddxxtteerrmm(1)
  49.           terminal emulator    or by a    VT330 or VT340 terminal),
  50.           Tektronix    format itself, and device-independent GNU
  51.           metafile format.    Unless _t_y_p_e  is     "X",  an  output
  52.           file is produced and written to standard output.
  53.  
  54.           Omitting    the --TT option is equivalent to specifying
  55.           --TT mmeettaa.    GNU metafile format may    be translated  to
  56.           other formats with pplloott(1).
  57.  
  58.        --pp _n
  59.        ----ppaaggee--nnuummbbeerr _n
  60.           Output  only  page  number  _n, within the    Tektronix
  61.  
  62.  
  63.  
  64. FSF                 Jun 2000                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TEK2PLOT(1)          GNU Plotting Utilities          TEK2PLOT(1)
  71.  
  72.  
  73.           file or sequence of Tektronix files that    is  being
  74.           translated.   _n  must  be     a  non-negative integer,
  75.           since a Tektronix    file may consist of one     or  more
  76.           pages, numbered beginning    with zero.
  77.  
  78.           The  default  behavior if    the --pp option is not used
  79.           is to output all nonempty    pages in succession.  For
  80.           example, tteekk22pplloott    --TT XX displays each Tektronix page
  81.           in its own X window.  If the --TT  ppnngg,  --TT     ppnnmm,  --TT
  82.           ggiiff,  --TT    aaii, or --TT ffiigg option is    used, the default
  83.           behavior is to output only the first nonempty  Tek
  84.           tronix  page,  since  files in those output formats
  85.           contain only a single page of graphics.
  86.  
  87.           Most Tektronix files consist  of    either    one  page
  88.           (page  #0) or two    pages (an empty    page #0, and page
  89.           #1).  Tektronix files produced by    the GNU     plotting
  90.           utilities     (e.g.,     by ggrraapphh --TT tteekk) are normally of
  91.           the latter sort.
  92.  
  93.        --FF _n_a_m_e
  94.        ----ffoonntt--nnaammee _n_a_m_e
  95.           Use the font _n_a_m_e    for  rendering    the  native  Tex
  96.           tronix fonts, if it is available.     The default font
  97.           is "Courier" except for tteekk22pplloott --TT  ppnngg,     tteekk22pplloott
  98.           --TT ppnnmm, tteekk22pplloott --TT ggiiff, tteekk22pplloott    --TT hhppggll, tteekk22pplloott
  99.           --TT rreeggiiss,    and tteekk22pplloott --TT     tteekk,  for  which  it  is
  100.           "HersheySerif".    A  list    of available fonts can be
  101.           obtained with the    ----hheellpp--ffoonnttss option (see  below).
  102.           If  a  font outside the Courier family is    used, the
  103.           ----ppoossiittiioonn--cchhaarrss option (see below) should probably
  104.           be specified.
  105.  
  106.           The  --FF  option  is  useful only if you have a Tek
  107.           tronix file that draws text using    native    Tektronix
  108.           fonts.   Tektronix  files    produced by the    GNU plot
  109.           ting utilities (e.g., by ggrraapphh --TT    tteekk) do     not  use
  110.           native  Tektronix     fonts:     they  use Hershey vector
  111.           fonts instead.
  112.  
  113.        --WW _l_i_n_e___w_i_d_t_h
  114.        ----lliinnee--wwiiddtthh _l_i_n_e___w_i_d_t_h
  115.           Set the width of lines, as a fraction of the  width
  116.           of the display, to be _l_i_n_e___w_i_d_t_h.     A negative value
  117.           means that a default value should     be  used.   This
  118.           value  is     format-dependent.  The    interpretation of
  119.           zero line    width is also format-dependent    (in  some
  120.           output  formats,    a zero-width line is the thinnest
  121.           line that    can be drawn;  in  others,  a  zero-width
  122.           line is invisible).
  123.  
  124.        ----bbgg--ccoolloorr _n_a_m_e
  125.           Set  the    color used for the background to be _n_a_m_e.
  126.           This is relevant only to tteekk22pplloott    --TT XX, tteekk22pplloott --TT
  127.  
  128.  
  129.  
  130. FSF                 Jun 2000                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. TEK2PLOT(1)          GNU Plotting Utilities          TEK2PLOT(1)
  137.  
  138.  
  139.           ppnngg,  tteekk22pplloott --TT    ppnnmm, tteekk22pplloott --TT ggiiff, tteekk22pplloott --TT
  140.           ssvvgg, tteekk22pplloott --TT ccggmm, and    tteekk22pplloott  --TT  rreeggiiss.   An
  141.           unrecognized  name  sets    the color to the default,
  142.           which  is     "white".    The   environment     variable
  143.           BBGG__CCOOLLOORR    can  equally  well be used to specify the
  144.           background color.     If the    --TT ssvvgg or --TT  ccggmm  option
  145.           is used, an output file without a    background may be
  146.           produced by setting the background color to "none".
  147.  
  148.           If the --TT    ppnngg or --TT ggiiff option is    used, a    transpar
  149.           ent PNG file or a    transparent  pseudo-GIF,  respec
  150.           tively,  may  be    produced by setting the    TTRRAANNSSPPAARR
  151.           EENNTT__CCOOLLOORR    environment variable to    the name  of  the
  152.           background color.
  153.  
  154.        ----bbiittmmaapp--ssiizzee _b_i_t_m_a_p___s_i_z_e
  155.           Set  the    size of    the graphics display in    which the
  156.           plot will    be drawn,  in  terms  of  pixels,  to  be
  157.           _b_i_t_m_a_p___s_i_z_e.   The  default  is "570x570".  This is
  158.           relevant only to pplloott --TT XX, pplloott --TT  ppnngg,     pplloott  --TT
  159.           ppnnmm,  and    pplloott --TT    ggiiff.  If you choose a rectangular
  160.           (non-square) window size,    the  fonts  in    the  plot
  161.           will  be scaled anisotropically, i.e., by    different
  162.           factors in the horizontal    and vertical  directions.
  163.           For pplloott --TT XX, this requires an X11R6 display.  Any
  164.           font that    cannot be scaled  in  this  way     will  be
  165.           replaced    by  a  default scalable    font, such as the
  166.           vector font "HersheySerif".
  167.  
  168.           The environment  variable     BBIITTMMAAPPSSIIZZEE  can  equally
  169.           well be used to specify the window size.    For back
  170.           ward compatibility, the X     resource  XXpplloott..ggeeoommeettrryy
  171.           may be used instead.
  172.  
  173.        ----eemmuullaattee--ccoolloorr _o_p_t_i_o_n
  174.           If  _o_p_t_i_o_n is _y_e_s, replace each color in the output
  175.           by an appropriate    shade of gray.     This  is  seldom
  176.           useful, except when using    ` tteekk22pplloott --TT ppccll to pre
  177.           pare output for a    PCL 5 device.    (Many  monochrome
  178.           PCL  5  devices, such as monochrome LaserJets, do    a
  179.           poor job of emulating color on their own.)  You may
  180.           equally well request color emulation by setting the
  181.           environment variable EEMMUULLAATTEE__CCOOLLOORR to "yes".
  182.  
  183.        ----mmaaxx--lliinnee--lleennggtthh _m_a_x___l_i_n_e___l_e_n_g_t_h
  184.           Set the maximum number of    points that  a    polygonal
  185.           line  may     contain, before it is flushed out, to be
  186.           _m_a_x___l_i_n_e___l_e_n_g_t_h.     If  this  flushing  occurs,  the
  187.           polygonal     line will be split into two or    more sub-
  188.           lines, though the    splitting should not  be  notice
  189.           able.  The default value of _m_a_x___l_i_n_e___l_e_n_g_t_h is 500.
  190.  
  191.           The reason for splitting long  polygonal    lines  is
  192.           that  some  display  devices  (e.g., old Postscript
  193.  
  194.  
  195.  
  196. FSF                 Jun 2000                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. TEK2PLOT(1)          GNU Plotting Utilities          TEK2PLOT(1)
  203.  
  204.  
  205.           printers    and  HP-GL  pen     plotters)  have  limited
  206.           buffer    sizes.       The      environment     variable
  207.           MMAAXX__LLIINNEE__LLEENNGGTTHH can also be  used     to  specify  the
  208.           maximum line length.
  209.  
  210.        ----ppaaggee--ssiizzee _p_a_g_e_s_i_z_e
  211.           Set  the size of the page    on which the plot will be
  212.           positioned.  This    is relevant only to  tteekk22pplloott  --TT
  213.           ssvvgg,  tteekk22pplloott  --TT  aaii, tteekk22pplloott --TT ppss, tteekk22pplloott --TT
  214.           ccggmm, tteekk22pplloott --TT ffiigg, tteekk22pplloott --TT    ppccll, and tteekk22pplloott
  215.           --TT  hhppggll.      The default is "letter", which means an
  216.           8.5 inch by 11 inch page.     Any ISO page size in the
  217.           range  "a0"..."a4"  or  ANSI page    size in    the range
  218.           "a"..."e"    may be specified ("letter"  is    an  alias
  219.           for  "a"    and  "tabloid"    is  an    alias  for  "b").
  220.           "legal" and  "ledger"  are  recognized  page  sizes
  221.           also.    The   environment  variable  PPAAGGEESSIIZZEE  can
  222.           equally well be used to specify the page size.
  223.  
  224.           The graphics display in which  the  plot    is  drawn
  225.           will  be    a  square region that would occupy nearly
  226.           the full width of    the specified page.  An     alterna
  227.           tive  size  for  the graphics display can    be speci
  228.           fied.  For example, the page size    could  be  speci
  229.           fied     as     "letter,xsize=4in,ysize=6in",    or
  230.           "a4,xsize=5.0cm,ysize=100mm".  For all of    the above
  231.           except tteekk22pplloott --TT hhppggll, the graphics display will,
  232.           by default, be centered on the page.   For  all  of
  233.           the  above  except  tteekk22pplloott --TT ssvvgg and tteekk22pplloott --TT
  234.           ccggmm, the graphics    display    may be repositioned manu
  235.           ally,  by    specifying the location    of its lower left
  236.           corner, relative to the lower left  corner  of  the
  237.           page.   For  example, the    page size could    be speci
  238.           fied   as      "letter,xorigin=2in,yorigin=3in",    or
  239.           "a4,xorigin=0.5cm,yorigin=0.5cm".      It is    also pos
  240.           sible to specify an offset  vector.   For     example,
  241.           the  page     size could be specified as "letter,xoff
  242.           set=1in",    or "letter,xoffset=1in,yoffset=1.2in", or
  243.           "a4,yoffset=-1cm".  In SVG format    and WebCGM format
  244.           it is possible to    specify    the size of the     graphics
  245.           display, but not its position.
  246.  
  247.        ----ppeenn--ccoolloorr _n_a_m_e
  248.           Set the pen color    to be _n_a_m_e.  An    unrecognized name
  249.           sets  the     pen  color  to     the  default,    which  is
  250.           "black".
  251.  
  252.        ----ppoossiittiioonn--cchhaarrss
  253.           Position    the  characters    in each    text string indi
  254.           vidually.     If the    text font is not a member of  the
  255.           Courier  family,    and  especially     if  it     is not    a
  256.           fixed-width font,    this option is    recommended.   It
  257.           will improve the appearance of text strings, at the
  258.           price of making it difficult  to    edit  the  output
  259.  
  260.  
  261.  
  262. FSF                 Jun 2000                4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. TEK2PLOT(1)          GNU Plotting Utilities          TEK2PLOT(1)
  269.  
  270.  
  271.           file with    xxffiigg(1), iiddrraaww(1), or Illustrator.
  272.  
  273.        ----rroottaattiioonn _a_n_g_l_e
  274.           Rotate the graphics display by _a_n_g_l_e degrees.  Rec
  275.           ognized values are "0",  "90",  "180",  and  "270".
  276.           "no"  and     "yes"    are  equivalent     to "0"    and "90",
  277.           respectively.  The  environment  variable     RROOTTAATTIIOONN
  278.           can also be used to specify a rotation angle.
  279.  
  280.        ----uussee--tteekk--ffoonnttss
  281.           Use the bitmap fonts that    were used on the original
  282.           Tektronix    4010/4014 terminal.  This option is rele
  283.           vant  only  to  tteekk22pplloott    --TT  XX.    The four relevant
  284.           bitmap fonts are distributed with    most versions  of
  285.           the   GNU      plotting  utilities,    under  the  names
  286.           "tekfont0"..."tekfont3".     They    can   easily   be
  287.           installed     on  any  modern X Window System display.
  288.           For this option to work  properly,  you  must  also
  289.           select a window size of 1024x1024    pixels,    either by
  290.           using the    ----bbiittmmaapp--ssiizzee 11002244xx11002244    option or by set
  291.           ting  the     value    of  the     XXpplloott..ggeeoommeettrryy    resource.
  292.           This is because bitmap fonts, unlike  the     scalable
  293.           fonts   that  tteekk22pplloott  normally    uses,  cannot  be
  294.           rescaled.
  295.  
  296.           This option is useful only if you    have  a     file  in
  297.           Tektronix     format    that draws text    using native Tek
  298.           tronix fonts.  Tektronix files produced by the  GNU
  299.           plotting    utilities  (e.g., by ggrraapphh --TT tteekk) do not
  300.           use native Tektronix fonts: they use Hershey vector
  301.           fonts instead.
  302.  
  303.    OOppttiioonnss ffoorr MMeettaaffiillee    OOuuttppuutt
  304.        The  following option is    relevant only if the --TT    option is
  305.        omitted or if --TT    mmeettaa is    used.  In this case tteekk22pplloott out
  306.        puts  a GNU graphics metafile, which must be translated to
  307.        other formats with pplloott(1).
  308.  
  309.        --OO
  310.        ----ppoorrttaabbllee--oouuttppuutt
  311.           Output the portable (human-readable) version of GNU
  312.           metafile    format,    rather than a binary version (the
  313.           default).     The format  of     the  binary  version  is
  314.           machine-dependent.
  315.  
  316.    IInnffoorrmmaattiioonnaall OOppttiioonnss
  317.        ----hheellpp Print a list of command-line options, and    exit.
  318.  
  319.        ----hheellpp--ffoonnttss
  320.           Print  a    table  of available fonts, and exit.  The
  321.           table will depend    on which output    format or display
  322.           type  is specified with the --TT option.  tteekk22pplloott --TT
  323.           XX, tteekk22pplloott --TT ssvvgg, tteekk22pplloott --TT aaii, tteekk22pplloott --TT ppss,
  324.           tteekk22pplloott    --TT  ccggmm, and tteekk22pplloott --TT ffiigg each support
  325.  
  326.  
  327.  
  328. FSF                 Jun 2000                5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. TEK2PLOT(1)          GNU Plotting Utilities          TEK2PLOT(1)
  335.  
  336.  
  337.           the 35 standard Postscript fonts.     tteekk22pplloott --TT ssvvgg,
  338.           tteekk22pplloott    --TT  ppccll, and tteekk22pplloott --TT hhppggll support the
  339.           45 standard PCL 5    fonts, and the latter two support
  340.           a     number     of  Hewlett-Packard  vector  fonts.  All
  341.           seven support a set of 22    Hershey    vector fonts,  as
  342.           do  tteekk22pplloott  --TT    ppnngg, tteekk22pplloott --TT ppnnmm, tteekk22pplloott --TT
  343.           ggiiff,  tteekk22pplloott  --TT  rreeggiiss,  and  tteekk22pplloott     --TT  tteekk.
  344.           tteekk22pplloott    without    a --TT option in principle supports
  345.           any of these fonts, since    its output must    be trans
  346.           lated to other formats with pplloott(1).
  347.  
  348.           The  pplloottffoonntt(1)    utility     may  be used to obtain    a
  349.           character    map of any supported font.
  350.  
  351.        ----lliisstt--ffoonnttss
  352.           Like ----hheellpp--ffoonnttss, but lists the fonts in    a  single
  353.           column  to facilitate piping to other programs.  If
  354.           no output    format is specified with the  --TT  option,
  355.           the full set of supported    fonts is listed.
  356.  
  357.        ----vveerrssiioonn
  358.           Print  the version number    of tteekk22pplloott and    the plot
  359.           ting utilities package, and exit.
  360.  
  361. EENNVVIIRROONNMMEENNTT
  362.        The environment variables BBIITTMMAAPPSSIIZZEE,, PPAAGGEESSIIZZEE,,    BBGG__CCOOLLOORR,,
  363.        EEMMUULLAATTEE__CCOOLLOORR,, MMAAXX__LLIINNEE__LLEENNGGTTHH and RROOTTAATTIIOONN serve as back
  364.        ups   for   the     options   ----bbiittmmaapp--ssiizzee,    ----ppaaggee--ssiizzee,
  365.        ----bbgg--ccoolloorr,    ----eemmuullaattee--ccoolloorr,     ----mmaaxx--lliinnee--lleennggtthh,   and
  366.        ----rroottaattiioonn, respectively.  The remaining    environment vari
  367.        ables are specific to individual    output formats.
  368.  
  369.        tteekk22pplloott     --TT XX, which pops up a window on an X Window Sys
  370.        tem display and draws graphics in it, checks  the  DDIISSPPLLAAYY
  371.        environment  variable.    Its  value determines the display
  372.        that will be used.
  373.  
  374.        tteekk22pplloott    --TT ppnngg and tteekk22pplloott --TT ggiiff, which produce  output
  375.        in  PNG    format    and  pseudo-GIF     format    respectively, are
  376.        affected    by the IINNTTEERRLLAACCEE environment  variable.      If  its
  377.        value  is  "yes", the output will be interlaced.     Also, if
  378.        the TTRRAANNSSPPAARREENNTT__CCOOLLOORR environment variable is set  to  the
  379.        name of a color,    that color will    be treated as transparent
  380.        in the output.
  381.  
  382.        tteekk22pplloott    --TT ppnnmm,    which produces output in portable  anymap
  383.        (PBM/PGM/PPM)  format,  is  affected  by     the PPNNMM__PPOORRTTAABBLLEE
  384.        environment variable.  If its value is "yes",  the  output
  385.        will be in a human-readable format rather than binary (the
  386.        default).
  387.  
  388.        tteekk22pplloott    --TT ccggmm,    which produces output  in  CGM    (Computer
  389.        Graphics    Metafile) format, is affected by the CCGGMM__MMAAXX__VVEERR
  390.        SSIIOONN and    CCGGMM__EENNCCOODDIINNGG environment variables.  By     default,
  391.  
  392.  
  393.  
  394. FSF                 Jun 2000                6
  395.  
  396.  
  397.  
  398.  
  399.  
  400. TEK2PLOT(1)          GNU Plotting Utilities          TEK2PLOT(1)
  401.  
  402.  
  403.        it produces a binary-encoded version of CGM version 3 for
  404.        mat.  For backward compatibility, the version  number  may
  405.        be  reduced  by    setting     CCGGMM__MMAAXX__VVEERRSSIIOONN  to  "2" or "1".
  406.        Irrespective of version,    the output CGM file will use  the
  407.        human-readable  clear text encoding if CCGGMM__EENNCCOODDIINNGG is set
  408.        to "clear_text".     However, only binary-encoded  CGM  files
  409.        conform to the WebCGM profile.
  410.  
  411.        tteekk22pplloott      --TT   ppccll,  which  produces  PCL  5  output  for
  412.        Hewlett-Packard printers    and plotters, is affected by  the
  413.        environment  variable PPCCLL__AASSSSIIGGNN__CCOOLLOORRSS..     It should be set
  414.        to "yes"    when producing PCL 5 output for    a  color  printer
  415.        or  other  color     device.  This will ensure accurate color
  416.        reproduction by giving the output device    complete  freedom
  417.        in  assigning  colors,  internally, to its "logical pens".
  418.        If it is    "no" then the device will use a    fixed set of col
  419.        ored  pens, and will emulate other colors by shading.  The
  420.        default is "no" because monochrome PCL  5  devices,  which
  421.        are  much  more common than colored ones, must use shading
  422.        to emulate color.
  423.  
  424.        tteekk22pplloott    --TT hhppggll, which produces    Hewlett-Packard     Graphics
  425.        Language     output, is affected by    several    environment vari
  426.        ables.  The most    important is HHPPGGLL__VVEERRSSIIOONN,, which  may  be
  427.        set  to    "1", "1.5", or "2" (the    default).  "1" means that
  428.        the output should be generic HP-GL, "1.5" means    that  the
  429.        output should be    suitable for the HP7550A graphics plotter
  430.        and the HP758x, HP7595A and HP7596A drafting plotters (HP-
  431.        GL  with     some HP-GL/2 extensions), and "2" means that the
  432.        output should be    modern HP-GL/2.     If the    version    is "1" or
  433.        "1.5"  then the only available fonts will be vector fonts,
  434.        and all lines will be drawn with    a default width     (the  --WW
  435.        option will not work).
  436.  
  437.        The  position  of the tteekk22pplloott --TT hhppggll graphics display on
  438.        the page    can be rotated    90  degrees  counterclockwise  by
  439.        setting    the  HHPPGGLL__RROOTTAATTEE  environment  variable    to "yes".
  440.        This is not the same as the  rotation  obtained    with  the
  441.        ----rroottaattiioonn option, since    it both    rotates    the graphics dis
  442.        play and    repositions its    lower left corner toward  another
  443.        corner  of  the    page.  Besides "no" and    "yes", recognized
  444.        values for HHPPGGLL__RROOTTAATTEE are "0", "90",  "180",  and  "270".
  445.        "no"  and  "yes"     are  equivalent to "0"    and "90", respec
  446.        tively.    "180" and "270"    are supported only  if    HHPPGGLL__VVEERR
  447.        SSIIOONN is "2" (the    default).
  448.  
  449.        By default, tteekk22pplloott --TT hhppggll will draw with a fixed set of
  450.        pens.  Which pens are present may be specified by  setting
  451.        the  HHPPGGLL__PPEENNSS  environment  variable.  If HHPPGGLL__VVEERRSSIIOONN is
  452.        "1", the    default     value    of  HHPPGGLL__PPEENNSS  is  "1=black";  if
  453.        HHPPGGLL__VVEERRSSIIOONN  is     "1.5"    or  "2",  the  default    value  of
  454.        HHPPGGLL__PPEENNSS     is        "1=black:2=red:3=green:4=yel
  455.        low:5=blue:6=magenta:7=cyan".   The format should be self-
  456.        explanatory.  By    setting    HHPPGGLL__PPEENNSS you may specify a color
  457.  
  458.  
  459.  
  460. FSF                 Jun 2000                7
  461.  
  462.  
  463.  
  464.  
  465.  
  466. TEK2PLOT(1)          GNU Plotting Utilities          TEK2PLOT(1)
  467.  
  468.  
  469.        for any pen in the range    #1...#31.  All color names recog
  470.        nized by    the X Window System may    be  used.   Pen     #1  must
  471.        always be present, though it need not be    black.    Any other
  472.        pen in the range    #1...#31 may be    omitted.
  473.  
  474.        If HHPPGGLL__VVEERRSSIIOONN is "2" then tteekk22pplloott --TT hhppggll will also  be
  475.        affected     by  the environment variable HHPPGGLL__AASSSSIIGGNN__CCOOLLOORRSS..
  476.        If its value is "yes", then tteekk22pplloott --TT hhppggll will  not  be
  477.        restricted  to the palette specified in HHPPGGLL__PPEENNSS:: it will
  478.        assign colors to    "logical pens" in the range #1...#31,  as
  479.        needed.     The  default  value  is  "no" because other than
  480.        color LaserJet printers and DesignJet plotters,    not  many
  481.        HP-GL/2    devices    allow the assignment of    colors to logical
  482.        pens.
  483.  
  484.        The drawing of visible white lines is  supported     only  if
  485.        HHPPGGLL__VVEERRSSIIOONN   is   "2"     and   the  environment     variable
  486.        HHPPGGLL__OOPPAAQQUUEE__MMOODDEE    is "yes" (the default).     If its    value  is
  487.        "no"  then  white lines (if any), which are normally drawn
  488.        with pen    #0, will not be    drawn.    This feature is    to accom
  489.        modate  older  HP-GL/2 devices.    HP-GL/2    pen plotters, for
  490.        example,    do not support the use of pen #0 to draw  visible
  491.        white  lines.   Some  older  HP-GL/2 devices may, in fact,
  492.        malfunction if asked to draw opaque objects.
  493.  
  494. SSEEEE AALLSSOO
  495.        pplloott(1),    pplloottffoonntt(1), and "The GNU Plotting Utilities Man
  496.        ual".
  497.  
  498. AAUUTTHHOORRSS
  499.        tteekk22pplloott     was  written  by  Robert S. Maier (rrssmm@@mmaatthh..aarrii
  500.        zzoonnaa..eedduu).  It incorporates a Tektronix parser written  by
  501.        Edward Moy (mmooyy@@ppaarrcc..xxeerrooxx..ccoomm).
  502.  
  503. BBUUGGSS
  504.        Email bug reports to bbuugg--ggnnuu--uuttiillss@@ggnnuu..oorrgg.
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526. FSF                 Jun 2000                8
  527.  
  528.  
  529.